home *** CD-ROM | disk | FTP | other *** search
/ TOS Silver 2000 / TOS Silver 2000.iso / musik / MIDIFP21 / MIDI_PRT.DOC < prev    next >
Encoding:
Text File  |  1996-12-08  |  21.6 KB  |  567 lines
  1. Midi File Printer V2.1 User Manual
  2. ==================================
  3.  
  4. Introduction
  5. ------------
  6. The MIDI File Printer prints notes out of standard MIDI files in a 
  7. very easy writing.
  8. It is the only program of this kind I know, and perhaps the only
  9. one of the world (of course, in this context, "world" means our
  10. little planet).
  11. The MIDI File Printer is a modern program for Atari ST(E)/TT/Falcon 
  12. and compatible computers and thus should be runable in each screen
  13. resolution and on top of multitasking operating systems like
  14. Multi-TOS, Magic! and Multi-GEM. Output is done via GDOS. Scrap
  15. files can be written to the GEM clipboard and from there they
  16. can be inserted into other programs (e.g. via "paste" into Atari's
  17. Works).
  18.  
  19.  
  20. Copyright
  21. ---------
  22. The Midi File Printer Version V2.0 may be copied freely.
  23. Anybody who wants may use it, a sale of the program is not allowed.
  24.  
  25. It is not allowed to omit any of the delivered files when the  
  26. program is passed on (delivered files see below).
  27.  
  28. The author of the program is:
  29.  
  30. Harald Wolfgang Rieder              phone:  Germany - 089 3159 7200
  31. Am Stutenanger 11d
  32.  
  33. D-85764 Oberschleissheim
  34.  
  35.  
  36. Legal stuff
  37. -----------
  38. USE THIS PROGRAM AT YOUR OWN RISK!  The author assumes no liability
  39. what-so-ever for any damages that may result from using this program
  40. or its accompanying files.  This program includes absolutely no
  41. warranty, written or implied.
  42.  
  43.  
  44. Sense
  45. -----
  46. In the year 1991, after making music 22 years on various
  47. instruments, I still had to intensively practise voicings and
  48. scales on the piano, and there were difficult keys and easy keys.
  49. And the moment came when I did not understand any more, why pieces
  50. like "Giant Steps" from John Coltrane, which consist of simple 
  51. chord progressions, should be so much easier to play on a guitar 
  52. than on a piano.
  53.  
  54. I decided that it should become easier to play the piano.
  55.  
  56. For this purpose I re-arranged the keys of my piano (of course I
  57. had to buy some new keys from the manufacturer, thanks to 
  58. F.A.T.A.R.):
  59.  
  60.  
  61.  
  62.        A#    C#  D#    F#  G#
  63.    |  | | | | | | | | | | | |
  64.    |  | | | | | | | | | | | |
  65.    |  | | | | | | | | | | | | ...         OLD
  66.    |  |_| | |_| |_| | |_| |_|
  67.    |   |  |  |   |  |  |   |
  68.    | A | H|C | D | E|F | G | A
  69.    |___|__|__|___|__|__|___|__
  70.  
  71.      
  72.  
  73.  
  74.      dodecime start
  75.            |
  76.        A   0   2   4   6   8
  77.    |  | |:| | | | | |.| | | |
  78.    |  | |:| | | | | |.| | | |
  79.    |  | |:| | | | | |.| | | | ...         NEW
  80.    |  |_|:|_| |_| |_|.|_| |_|
  81.    |   |:::|   |   |...|   | 
  82.    | 9 |:B:| 1 | 3 |.5.| 7 | 9
  83.    |___|:::|___|___|...|___|__
  84.          ^           ^
  85.          |           |
  86.     dark brown  light brown
  87.  
  88.  
  89.  
  90. With the new arrangement of keys only 2 different keys need to
  91. be practised, with the old arrangement of keys there had been
  92. 12 different keys.
  93.  
  94. Then I started to learn how to play the new piano. It took me 2 years
  95. to get as good as I was before. But many things have become simple,
  96. for example "Giant Steps".
  97.  
  98. Unfortunately the usual note writings all are suitable for 
  99. old pianos and similar instruments. They are neither suitable for 
  100. my new piano, nor are they suitable for guitars, violins, voices, 
  101. ... . 
  102.  
  103. I had to find a note writing fitting to my new piano. This note
  104. writing would fit also for guitars, violins, voices, ... .
  105.  
  106. Here it is, it is so simple that it is self-explaining:
  107.  
  108.  
  109. log(frequency)
  110.  
  111.  ^       (mode: "Mix", 6 horizontal lines)
  112.  |                  
  113.  |   |------------|------------|------------|---
  114.  |   |            |            |            |   
  115.  |   |------------|------------|------------|[2]
  116.  |   |            |            |         [1]|
  117.  | 4 |============|============|======[0]===|===
  118.  |   |            |            |   [B]      |
  119.  |   |------------|------------|[A]---------|---
  120.  |   |            |         [9]|            |
  121.  |   |------------|------[8]---|------------|---
  122.  |   |            |   [7]      |            |
  123.  |   |------------|[6]---------|------------|---
  124.  |   |         [5]|            |            |
  125.  |   |------[4]---|------------|------------|---
  126.  |   |   [3]      |            |            |
  127.  |   |[2]---------|------------|------------|---
  128.  |                 
  129.  |
  130.  +-----------------------------------------------> time
  131.  
  132.  
  133. 0..B in [] stand for note number (= offset to dodecime start)
  134. 4 stands for dodecime number 4
  135. (whole note number = dodecime number * 12 + offset to dodecime start)
  136.  
  137.  
  138. The diagram shows a chromatic scale, beginning with a 2 (=D) and 
  139. ending with a 2 (=D) one dodecime (=octave) higher. All notes 
  140. have the same duration, succeeding notes have the same frequency
  141. ratio in this example.
  142.  
  143. In the new writing it is possible to show the exact duration of a
  144. note (for example as played by a great musician) very easily.
  145. Trills can be written without using new elements. Glissandi 
  146. can also be shown in a simple way. And so on.
  147.  
  148. The Midi File Printer in its current version only shows notes
  149. and their durations as well as their note-on dynamics (loud notes 
  150. are high in y-direction). It does not show any controller 
  151. information like sustain pedal, modulation and pitch wheels.
  152.  
  153. I also use a more logical writing for chords, but this shall
  154. not be a topic of this user manual, since the MIDI File Printer
  155. does not (yet ?) show any chords.
  156.  
  157.  
  158. Delivery
  159. --------
  160. You should have the following files:
  161.  
  162. MIDIPRTS.APP
  163. or
  164. MIDIPRTS.GTP: a program variant for ST-like computers, 
  165.               you can rename the program yourself. But do not 
  166.               try to use it as accessory or in the AUTO folder.
  167. MIDIPRTT.APP 
  168. or
  169. MIDIPRTT.GTP: a program variant for TT-like computers (i.e. with
  170.               at least 68020 processor and with FPU).
  171. MIDI_PRT.PAR: default parameter file. The default parameters
  172.               are used if no extra parameter file is found for a
  173.               certain MIDI file. You can yourself generate your
  174.               default parameter file.
  175. MIDI_PRT.DOC: this user manual.
  176. EXAMPLE     : a folder with some public domain standard MIDI files 
  177.               including parameter files.
  178.               
  179. You might have:
  180.  
  181. DESKTOP.CFG:  automatically generated, don't care
  182.  
  183.  
  184. Setup
  185. -----
  186. Copy at least MIDIPRTx.APP/GTP to the desired destination. 
  187. Rename it if desired. Install it as an icon on the desktop if
  188. you want quick access or associate it with the extension ".mid",
  189. if you like. Note that the program needs full paths as input
  190. parameters ! The standard path should be the one of the program,
  191. otherwise you will get many DESKTOP.CFGs on your disk.
  192. MIDI_PRT.PAR can be created by yourself if you do not like the
  193. delivered default parameter file. On CD-ROM you can not define 
  194. your own default parameters. MIDI_PRT.PAR must be in the same 
  195. directory as MIDIPRTx.PRG/GTP.
  196.  
  197. You need a GDOS for printing. The GDOS printer driver must have
  198. device number 21 in ASSIGN.SYS, the metafile driver must have 
  199. device number 31.
  200.  
  201. If the printout is not similar to the graphics on the screen, GDOS
  202. has to be blamed for that in most cases. With Speedo-GDOS you can
  203. achieve a 1:1 printout. However there are 3 problems known to me, 
  204. which I watched with my HP Deskjet printer:
  205.  
  206. - The quality must not be set to "draft". Otherwise some lines 
  207.   will be missing.
  208. - Using text attribute "light" leads to missing letters.
  209. - Using text attribute "outlined" leads to a crash !!
  210.  
  211. The problems occur with Speedo-GDOS releases 4.x and 5.0.
  212. If you use Speedo-GDOS, switch the print area switch to "off" and
  213. select the right paper size.
  214.  
  215.  
  216. Using the MIDI File Printer
  217. ---------------------------
  218.  
  219. 0. The Desktop
  220. 1. The Display Window
  221. 2. The Info Window
  222. 3. The Filter Window
  223. 4. The Parameter Window
  224. 5. The Drawer Window
  225. 6. The Printer Window
  226.  
  227.  
  228. 0. The Desktop (of the MIDI File Printer)
  229.  
  230. The MIDI File Printer has an own desktop, which manages icones. 
  231. This is owed to the fact that the MIDI File Printer has been 
  232. programmed using ACS.
  233. At this place I'd like to thank Mr. Stefan Bachert for his 
  234. ingenious ACS.
  235.  
  236. There are always at least 2 icons on the desktop:
  237.  
  238. NEW:     double click to NEW opens the file selector box and you
  239.          can select a MIDI standard file for processing.
  240.          You can repeat that until your memory is used up.
  241.          Each time new incarnations of the
  242.          display-, info-, filter-, parameter-, drawer- and printer-
  243.          windows will be created, shown as icons on the desktop.
  244. TRASH:   remove an incarnation by dragging any of its icons onto
  245.          the trash bin.
  246.  
  247. Open a window with a double click on its icon. If you close an
  248. open window it will be iconified on the desktop.
  249.  
  250. The meaning of the entries in the menu bar are:
  251.  
  252. about me:       information about the MIDI File Printer. It shows
  253.                 a simple drawing of the keyboard I use.
  254. info:           a little help function for people who don't read
  255.                 user manuals.
  256. open:           Opens the windows of all selected icons. If no icons 
  257.                 are selected this corresponds to a double click to 
  258.                 NEW.
  259. close:          iconifies the top window.
  260. remove:         corresponds to dragging icons onto TRASH.
  261. quit:           terminates the MIDI File Printer.
  262. window:         tops the next open window. The desktop is counted
  263.                 as window.
  264. from list:      tops the next window. Iconified windows are opened.
  265. horizontal:     arranges icons in a horizontal way
  266. vertical:       arranges icons in a vertical way
  267. load module:    an ACS module can be loaded
  268.  
  269.  
  270. 1. The Display Window - Icon: Note Writing
  271.  
  272. Here you can see the note systems. Since this window is the largest
  273. one, it contains the whole path name of your MIDI file in its info
  274. line. 
  275. The printable area corresponds to the inner window area.
  276. You can use the "+" and "-" keys for zooming and the arrow keys
  277. for turning over the pages.
  278.  
  279.  
  280. 2. The Info Window - Icon: Question Mark
  281.  
  282. This windows contains informations about the standard MIDI file.
  283.  
  284. file size:       size of the file on disk.
  285. transformed:     the standard MIDI file format is not suitable for 
  286.                  fast access. The MIDI file printer therefore uses
  287.                  an own format which in general needs more RAM.
  288.                  Here you see how much RAM is used by the transformed
  289.                  file.
  290. Midi file type:  "$" means, that the succeeding number is hex.
  291.                  I tested the MIDI File Printer with type 1 standard
  292.                  MIDI files. These are the most widely spread types
  293.                  (I never ever saw a type 0 or type 2 file).
  294. no. of tracks:   number of tracks that have been found in the MIDI
  295.                  file. In general not every track contains note
  296.                  events.
  297. ticks per beat:  time resolution of the MIDI standard file.
  298. SMPTE:           SMPTE format is not (yet ?) supported by the
  299.                  MIDI File Printer.
  300. ticks per frame: time resolution in case of SMPTE format.
  301.  
  302.  
  303. 3. The Filter Window - Icon: Coffee Filter
  304.  
  305. upper field:     contains the track name, if there has one been
  306.                  found in the MIDI file.
  307. track:           number of the track currently displayed.
  308. arrow buttons:   for choosing tracks. You can also use the keyboard
  309.                  and press the corresponding keys.
  310. on/off:          switches the whole track on or off. Tracks switched
  311.                  off are not printed.
  312. channels:        here you can select for each track the MIDI
  313.                  channels to be printed. A pressed button means
  314.                  that the corresponding channel is switched on.
  315.                  Channel buttons of empty channels are disabled.
  316.  
  317.  
  318. 4. The Parameter Window - Icon: x/y-parameters
  319.  
  320. Title:           title of the piece. Editable.
  321.                  If you load a file and the parameters file 
  322.                  (extra or default) contains an empty title, 
  323.                  the name of your MIDI file will be suggested 
  324.                  for the title. If you select "load", the suggestion
  325.                  will be taken back.
  326. bars per system: bars to be used per line. Editable.
  327. bar length:      number of 1/8 per bar. Editable.
  328. sub-bars:        determines the number of dashed auxiliary
  329.                  lines. Editable.
  330. left border,
  331. right border,
  332. upper border,
  333. lower border:    The GDOS printer driver tells the MIDI File Printer
  334.                  the size of the printable area. Here you can
  335.                  further reduce the area to be used by the MIDI File
  336.                  printer. All values are shown in per cent of the
  337.                  printable width/height. Editable.
  338. system distance: y-distance between 2 tracks systems in per hundred of  
  339.                  the printable height. Editable.
  340. track distance:  y-distance between 2 tracks in per hundred of the
  341.                  printable height. Editable.
  342. note distance:   y-distance between 2 succeeding notes in per thousand 
  343.                  of the printable height. Editable.
  344. average height:  y-size of note with mean dynamic
  345. dynamic:         y-sensivity (-> note on dynamic)
  346. horizontal l.:   number of horizontal lines to be painted per dodecime
  347. right field:     here you can determine the appearance either of 
  348.                  the notes or of the background bar. It is selectable 
  349.                  with the entries "note" and "background" in the menu 
  350.                  bar of the parameters window which of them is shown.
  351.                  Notes:
  352.                  You can determine colour, shape, pattern to be used.
  353.                  Colour and pattern per note.
  354.                  Background:
  355.                  You can determine colour and pattern to be used, per
  356.                  dodecime.
  357.  
  358. All parameters can be saved to file, see below.
  359.  
  360. Menu bar:
  361.  
  362. load:          tries to load {midifilename}.PAR. For example, if you 
  363.                work on ENDLESS.MID, the MIDI File Printer tries
  364.                to load ENDLESS.PAR.
  365. save:          saves the current parameters in {midifilename}.PAR.
  366. load...:       same as "load", but you can select a file name.
  367. save...:       same as "save", but you can select a file name.
  368. bold, light,
  369. italic,
  370. underlined,
  371. outlined:      headline style. See above for problems.
  372. note:          shows the note parameters in the right field.
  373. background:    shows the background parameters in the right field.
  374. fonts...:      opens a window for selecting a font (for the headline
  375.                and the dodecime numbers). This window disappeares
  376.                when being closed.
  377. Beyreuther:    time division and background according to 
  378.                Beyreuther's notation
  379. Rieder    :    time division and abckground according to 
  380.                Rieder's notation
  381. Mix       :    a mixture of both
  382.                
  383.  
  384. 5. The Drawer Window - Icon: Pencil Draws On Sheet
  385.  
  386. Here you can turn over the leaves and determine the zooming.
  387. I recommend to check how many pages have been generated before
  388. starting the printer. The printout is only interuptable by turning
  389. off the printer.
  390.  
  391. page:          Number of page currently displayed. Counting starts
  392.                with zero (this is the future).
  393. arrow buttons: to next/previous/first/last page. You can also use
  394.                the arrow keys of your keyboard.
  395. -/+ buttons:   zoom out / zoom in.
  396.  
  397.  
  398. 6. The Printer Window - Icon: Printer
  399.  
  400. from .. to .. : if this button is selected you can define a range
  401.                 of pages to be printed.
  402. current:        the page currently displayed shall be printed.
  403. all:            all pages are printed.
  404. all into 1:     all pages are printed into SCRAP.GEM. Pages are
  405.                 separated by "form advance". 
  406.                 If not selected, one metafile is generated per page. 
  407.                 Then, the page number is visible in the file name.
  408.  
  409. to file:        metafiles are written to the GEM clipboard.
  410.                 If there is not yet a clipboard, the MIDI file
  411.                 printer creates one with path "\clipboard\". 
  412. ok:             starts printing/metafiling
  413. processing:     shows which page is currently put out.
  414.  
  415.  
  416. End
  417. ---
  418. I wish you much fun with the MIDI File Printer (I know, having 
  419. fun with computers is sometimes not so easy).
  420.  
  421. The Mad Harry    Munich 1994/10/18
  422.  
  423.  
  424. If you are further interested in modern notations:
  425.  
  426.   Music Notation Modernization Association
  427.   P.O. Box 241
  428.   Kirksville
  429.   MO 63501
  430.  
  431.   U.S.A.
  432.  
  433.  
  434.  
  435. HISTORY
  436. =======
  437.  
  438. V0.2 first public release
  439. ----
  440.  
  441. V1.0 Corrected Faults:
  442. ---- 
  443.      - "exit" menu entry disappeared when selected (in certain
  444.        screen resolutions). Now titled "quit", which is more usual.
  445.      - when the last note system only contained note off events,
  446.        the y-sizes of the tracks were calculated wrongly. Now
  447.        they are calculated correctly.
  448.      - when using files with more than 9 tracks, a wrong track index 
  449.        could be displayed in the filter window.
  450.      
  451.      New Features:
  452.      
  453.      - more functions can be triggered from keyboard now.
  454.      - ACS modules can be loaded.
  455.      - V1.0 recognizes V0.2 parameter files and loads them correctly.
  456.      - the desktop has got a table-cloth.
  457.      - a program variant for computers with at least 68020 CPU and
  458.        with FPU is also delivered.
  459.      - MIDI File Printer now allocates memory in blocks of at
  460.        least 32 KByte. The GEMDOS memory management only can
  461.        administer a limited number of memory blocks.
  462.        Originally I intended to no more load the printer driver
  463.        and fonts at the start of MIDI_PRT but directly after the
  464.        "go" button in the printer window had been pressed.
  465.        This would have been a good new feature, since MIDI_PRT
  466.        then would not have prevented other programs from printing in
  467.        multitasking environments.
  468.        However this lead to severe problems with the memory 
  469.        management. GEMDOS gave away memory blocks to 2 users,
  470.        first to MIDI_PRT and then to GDOS. So, suddenly the
  471.        memory blocks used by MIDI_PRT were written by GDOS.
  472.        I could not find a work around for this problem, the only
  473.        hope is that Atari implements a better memory management.
  474.      - "info" entry in the menu bar of the desktop.
  475.      - printable area corresponds to inner area of the display
  476.        window. No more dashed lines necessary.
  477.      - turning over pages is possible if the display window 
  478.        or the info window is topped.
  479.      - changing filter settings immediately updates the 
  480.        display window ("return" needs no more to be presssed).
  481.      - changing parameters immediately updates the
  482.        display window ("return" needs no more to be pressed).
  483.      - note colour, background pattern and colour now can be 
  484.        selected, too.
  485.      - headline style is selectable. You do not need to install
  486.        extra GDOS fonts if the quality with these VDI attributes
  487.        is sufficient for you.
  488.      - "save ..." and "load ..." entries in the menu of the 
  489.        parameter window make it possible to select a file name
  490.        for the parameter file.
  491.      - zooming also reachable via buttons in the drawer window.
  492.      - page field in the drawer window no more editable.
  493.      - more than 1 metafiles can be generated at the same time.
  494.      - SCRAP.GEM is generated to support the "paste" commands
  495.        of other programs.
  496.      - the page currently put out is displayed.
  497.  
  498. V1.1 New Features:
  499. ---- 
  500.      - up to 128 GDOS fonts supported (formerly 19)
  501.      
  502. V1.2 Corrected Faults:
  503. ---- 
  504.      - Now the fonts are sorted correctly by their names 
  505.        (up to 32 characters long).
  506.  
  507. V1.5 Corrected Faults:
  508. ----
  509.      - bar length now measured in 1/8. In the former releases
  510.        for example 9/8 bars could not be properly displayed.
  511.        
  512.      New Features:
  513.      
  514.      - filter window indicates empty channels (buttons disabled)
  515.      - different patterns possible, dependent on note number
  516.      - line notation similar to Beyreuther's notation supported
  517.      
  518. V2.0 Corrected Faults:
  519. ----
  520.      - wrong dodecime numbers in Beyreuther mode
  521.      - font window not updated after loading of parameter file
  522.        
  523.      Known Faults:
  524.      
  525.      - dragging more than 1 icon of the same file onto the trash 
  526.        bin can lead to an endless loop showing alert boxes.
  527.     
  528.      New Features:
  529.      
  530.      - 2 new notation modes
  531.      - 0 now corresponds to note "C", no more to "H" ! This is a
  532.        concession to Marhold's and Beyreuther's notations.
  533.      - numbering of bars
  534.      - up to 12 different note colours per dodecime possible
  535.      - up to 9 different fill patterns per dodecime possible
  536.      - up to 12 different background colours possible
  537.      - up to 9 different background patterns possible
  538.      - thick lines instead of patterns can be chosen for the 
  539.        background
  540.      - 1,2,3,4 or 6 horizontal lines per dodecime possible
  541.      - different colours for different icons (per MIDI file)
  542.      
  543.      Version 0.x and version 1.x parameter files are no longer 
  544.      supported !
  545.      
  546. V2.0a New Features:
  547. -----
  548.      - a timer driven refresh (3 seconds) after text editing now
  549.        avoids screen confusion
  550.      - page number can be entered directly in the drawer window,
  551.        timer driven refresh with automatic input correction
  552.      - note number directly displayed in the parameters window
  553.      - no more info line in the display window saves precious
  554.        screen area
  555.        
  556. V2.1 Corrected Faults:
  557. ----
  558.      - printers with different resolutions in x- and y-direction
  559.        (e.g. 720 dpi * 360 dpi) now correctly supported.
  560.      
  561.      New Features:
  562.      
  563.      - takes long file names on command line
  564.      - takes more than 1 file name on command line
  565.      - only 1 metafile "SCRAP.GEM" generatable, pages are separated 
  566.        by "form advance". A good graphics program should treat that
  567.        correctly (try latest versions of ArtWorx and Kandinsky).